home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / sound / dupmod12.zip / DUPMOD12.DOC < prev    next >
Text File  |  1993-11-20  |  5KB  |  119 lines
  1. Program:        S3 Duplicate MOD Identification Utility (DUPMOD.EXE)
  2. Date:           11/20/93
  3. Version:        1.20
  4. Author:         George Spafford
  5.  
  6. Purpose:
  7.  
  8. To allow a user to compare a specified set of .MOD files to determine whether
  9. there are duplicate MOD files regardless of the DOS file name.
  10.  
  11. Install:
  12.  
  13. You can place DUPMOD.EXE anywhere in your PATH that you want to - you can even
  14. rename the DUPMOD.EXE file if you want to.
  15.  
  16. THIS PROGRAMS REQUIRES THAT YOU HAVE AT LEAST AN 80386 (SX or DX).
  17.  
  18. Procedure:
  19.  
  20. DUPMOD is run entirely from the command line.  Its usage is:
  21.  
  22.         DUPMOD sourcespec targetspec [name.log]
  23.  
  24.         sourcespec      this is the source file specification.  For example:
  25.                         C:\DL\*.MOD
  26.                         G:*.MOD
  27.                         and so on
  28.  
  29.                         If only the sourcespec is given, the program will
  30.                         assume that you want to compare those files against
  31.                         themselves.  For instance:
  32.                                 C:\MOD\*.MOD
  33.                         This will compare all of the .MOD files in the C:\MOD
  34.                         directory to one another.  This is faster than comparing
  35.                         files in other directories because a pointer is used
  36.                         that keeps the program from duplicating comparisons in
  37.                         the same directory.
  38.  
  39.         targetspec      this is the comparison directory where you want the
  40.                         files to be compared.
  41.                         C:\MOD\*.*
  42.                         D:\HOLD\*.MOD
  43.  
  44.                         DUPMOD C:\MOD\*.MOD G:\MOD\*.MOD
  45.  
  46.                         The above example will read each .MOD file in C:\MOD and
  47.                         compare it to every .MOD file in G:\MOD.
  48.  
  49.         name.log        This is the optional name of a log file to store
  50.                         findings to.  Otherwise the program will pause after
  51.                         each match.
  52.                         WHEN YOU USE THE LOG FILE, YOU MUST SPECIFY THE TARGET
  53.                         SPEC ALSO.  DUPMOD EXPECTS THE THIRD ARGUMENT ON THE
  54.                         COMMAND LINE TO BE THE LOG FILE NAME.
  55.  
  56. IMPORTANT:
  57.  
  58.         DUPMOD compares on the basis of the first 4,096 bytes of each file.
  59.         It does NOT take file names or sizes into consideration.  I did this
  60.         purposefully because of people renaming files and some files being
  61.         partially completed .MOD files.  The logic is as follows.
  62.  
  63.         1.      Find all matches to the source specification.
  64.         2.      Find all matches to the comparison specification.
  65.         3.      If the first 4K match, then it is declared a "DUPLICATE."
  66.         4.      If bytes 21 to 4096 match, then it is declared a
  67.                 "POSSIBLE DUPLICATE."
  68.  
  69.         The .MOD file structure stores the track title in the first
  70.         20 bytes.  I have a seen a lot of .MOD files with the track titles
  71.         changed.  Therefore, comparisons take place in the form of #3 and
  72.         #4 as listed above.
  73.  
  74.         Also note, when you are comparing files in the same directory, the
  75.         program will not compare a .MOD to itself, it will skip the file.
  76.         If your command line is:  DUPMOD C:*.MOD C:*.MOD   <- obviously your
  77.         source and comparison files are the same and A.MOD will be compared
  78.         to A.MOD, B.MOD to B.MOD and so forth - thus, we skipp identical file
  79.         names if it is the same directory.  I only mention this because it will
  80.         make the file counter appear inaccurate at times.
  81.  
  82. History:
  83.  
  84. 11/20/93        v1.2
  85.                 - Improved video routines
  86.                 - Compiled for 80386 only.  If you have an 8088, you will
  87.                   need to stick with version 1.0.
  88.  
  89. 10/25/93        v1.1
  90.  
  91.                 - Increased the file handling capabilities to 4,000.
  92.                 - Added a log file option
  93.  
  94. 06/20/93        v1.0    Initial shareware release.
  95.          
  96. Please Register Me:
  97.  
  98. DUPMOD is shareware.  As such, you can use it for 30 days.  If you continue
  99. to use the program after this period, you must register it in order to continue
  100. using it legally.  DUPMOD is $10 U.S. per copy.
  101.  
  102. Please make payments in US Currency (no cash please) to:
  103.  
  104.         George Spafford
  105.         3003 Lakeshore Drive #216
  106.         Saint Joseph, MI 49085
  107.  
  108. Unless required, notification of receipt will not be sent.        
  109. Comments and/or questions are always welcome.  I can be reached via the mail,
  110. EXEC-PC or Channel One
  111.  
  112. DUPMOD IS DISTRIBUTED AS IS.  THE AUTHOR (GEORGE SPAFFORD) MAKES NO
  113. WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO 
  114. WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, WITH 
  115. RESPECT TO THIS SOFTWARE AND DOCUMENTATION. IN NO EVENT SHALL THE AUTHOR 
  116. BE LIABLE FOR ANY DAMAGES, INCLUDING LOST PROFITS, LOST SAVINGS, OR ANY OTHER 
  117. INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF OR THE INABILITY 
  118. TO USE THIS PROGRAM.
  119.